home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / doc / ame.doc < prev    next >
Text File  |  1994-02-13  |  79KB  |  2,037 lines

  1. AME Documentation                        Andy Finkel
  2.  
  3.  
  4.  
  5.  
  6.     AME (pronounced 'amy') is a full screen text editor, based on 
  7. the public domain MicroEmacs code by David Conway, ported to the Amiga and 
  8. enhanced to take advantage of the special features of the Amiga.  
  9. You may be familiar with the older versions of MicroEmacs on the Amiga...
  10. AME is much more advanced.  Some special features of note are:
  11.  
  12.     Full Arexx Support
  13.     Programmable Menus
  14.     Programmable Functon keys
  15.     Better mouse support
  16.     Undo
  17.     EUC character support
  18.     complete keybord programmability
  19.     clipboard support
  20.     Scrollbar on window
  21.     2.0 look and feel
  22.     Public screen support
  23.     Incremental search
  24.     Pattern match search and replace
  25.     Command completion
  26.     Integrated with DICE
  27.     Shell variable support
  28.     AppWindow Support    
  29.     Locale Library Support
  30.     Iconification (AppIcon support)
  31.  
  32. INVOKING AME:
  33.     AME can be started from the Shell or from Workbench.  
  34.  
  35. Shell Use
  36. AME uses the 2.0 ReadArgs function for parsing its arguments.  It's template 
  37. is as follows:
  38.  
  39.  
  40. FROM/M,GOTO/K/N,SEARCH/K,WITH/K,PUBSCREEN/K,BASENAME/K,SCREEN/S,X/K/N,Y/K/N,
  41. WIDTH/K/N,HEIGHT/K/N,DEPTH/K/N,HUNT/K,NOSTART/S,WINDOW/K,NOBAR/S,DEFINE/K,AS/K: 
  42.  
  43. If started with no arguments, AME will automatically load the last file
  44. edited in that Shell, and place the cursor on the line where the cursor
  45. was located when the file was edited.  The last name and last line number
  46. are stored in local shell variables called AME_FILE and AME_LINE.  If these
  47. do not exist, AME searches for global environment variables with the same names.
  48. If those do not exist and no files are specified on the command line,
  49. AME comes up displaying an empty buffer named Main.  (The reason AME looks
  50. for the global environment variables is to handle the Workbench and the
  51. RUN AME case;  where there is no Shell environment to store the variables
  52. from one invocation of AME to the next).
  53.  
  54. AME supports loading multiple files.  Each file is loaded into its own buffer.
  55. A maximum of four buffers are displayed initially.  If more files are specified
  56. they are loaded, but they are not immediately visible.  AME also supports
  57. wild cards in file names, using the standard AmigaDOS wildcard routines.
  58.  
  59. The GOTO keyword allows you to specify a line number to 
  60. The AME window is normally divided into three parts:  The display window, 
  61. the mode line, and the echo line.  The display window is the area where most
  62. of the editing action takes place.   The mode line shows current status 
  63. information, such as file name, mode information, and so on.  The echo line 
  64. is the bottom line of the window, and can be used to enter extended commands 
  65. and parameters for commands.
  66.  
  67. The SEARCH keyword allows you so specify a search string.  On startup, AME
  68. will search the first buffer for that string;  if found, the cursor will
  69. be positioned at that point in the buffer.
  70.  
  71. After all files are loaded, AME runs its startup file(s).  These files must
  72. be Arexx scripts.  The standard startup file is S:AME_PRO.ame, and is executed
  73. first.  Then, if the WITH keyword is specified, that file is executed.
  74.  
  75. The NOSTART keyword will cause AME to not execute the S:AME_PRO.AME file on
  76. startup.  Any file specified by the WITH keyword will still be executed.
  77.  
  78. The PUBSCREEN option allows you to give the name of a public screen for AME to
  79. open its window on.
  80.  
  81. The BASENAME keyword allows you to specify a different basename for AME.  AME
  82. will use this as the basis for names for its Arexx port, and (if AME opens
  83. its own screen) as the name for its public screen.
  84.  
  85. The SCREEN keyword specifies that AME open its own screen, rather than opening
  86. on the Workbench screen.  By default, this will be a one bitplane screen.
  87. There will be no scroll bar, or scroll arrow gadgets;  instead, as much
  88. space as available will be used for the editing area.
  89.  
  90. The X and Y keywords allow you to specify the initial upper left corner location
  91. of  the intuition window that AME opens on the Workbench screen.
  92. The WIDTH and HEIGHT keywords allow you to specify the initial width and height
  93. for the Window; otherwise it defaults to what I think is a reasonable size
  94. for your current Workbench size.
  95.  
  96. The DEPTH keyword is used n conjunction with the SCREEN keyword to specify the
  97. number of bitplanes used by AME.  One bitplane is fastest.  Two give
  98. more color possibilities for mode line and cursor. 
  99.  
  100. The WINDOW keyword is used to tell AME to open in a CON: or AUX: (or even
  101. NIL:) window.  Instead of opening its own Intuition window, with menus,
  102. mouse support, and so on, the WINDOW keyword allows you to open AME
  103. in the current shell window (WINDOW *), in a new con: window (like
  104. WINDOW con:0/0/640/100/Hithere/Close), in a Newshell over the AUX: handler
  105. (use WINDOW * ) or even in background mode (WINDOW NIL:).  In background
  106. mode, no window is opened.  You can issue ARexx commands;  this allows
  107. you to quietly programatically edit files.  When the WINDOW keyword is
  108. used, the AME jump command can be used to switch from background
  109. to opening a CON: window, as well as to move to other public screens)
  110. All requesters automatically default to off when the WINDOW keyword
  111. is used (for remote use).  If for some reason you are using
  112. the WINDOW keyword while at the Amiga itself, you can turn on 
  113. the file requester (or all requesters) by using the SETPREFS command.
  114.  
  115. The NOBAR allows you to supress the scrollbar and scroll arrows.
  116.  
  117. The DEFINE and AS keywords work together to allow you to define a single
  118. local DOS variable when AME starts.  This would allow you to set a 
  119. variable containing a project name, an Arexx port name, whatever.  AME expands
  120. local variables in its echo command line, in menus, as arguments to commands,
  121. and so on. (AME uses the $ convention, like the Shell).  Both the DEFINE
  122. keyword (which specifies the variable name to set) and the AS (which specifies
  123. the value to set) are required.
  124.  
  125. Finally, AME supports a HUNT operation.  The HUNT keyword allows you to specify
  126. a project name.  AME will ask all other AMEs running on your system at that time
  127. for any AME with that project name.  If it finds one, it passes the file names
  128. specified in the command line to that AME for loading and/or display.  Otherwise,
  129. AME sets its own project name to the name specified by the HUNT keyword,
  130. and loads the specified files.  If HUNT and its keyword is specified, but no 
  131. filename, if the hunt fails, AME will automatically set the default project
  132. name for itself to what you were hunting for, and also try to load a file with
  133. the same name as the project name.
  134.  
  135.  
  136. AME Window layout
  137. -----------------
  138.  
  139. AME allows you to have more than one display window at the same time.  
  140. Basically, you can split the display window into two smaller display windows.  
  141. Each display window has its own mode line, and can be editing the same window 
  142. or different windows.
  143.  
  144.  
  145. TERMS
  146. -----
  147.  
  148. There are some terms used in the rest of the AME documentation that should
  149. be explained.  They are defined as follows:
  150.  
  151. The Display window        
  152.     You are probably familiar with the standard Intuition window.  AME 
  153. divides this window into several areas called display windows.  A display window
  154. consists of a set of lines.  These lines contain an image of the text you are
  155. editing.  At first you will probably only use one display window;  however,
  156. AME can subdivide the Intuition window into a number of display windows.  Each
  157. display window can edit a different file, or more than one display window
  158. can edit the same file.
  159.  
  160. Buffer
  161.     Text in AME is stored in Buffers.  Each display window has an associated
  162. buffer.  However, there is no rule that a buffer must be associated with
  163. a display window.  Buffers associated with a display window are visible.
  164. Buffers not associated with a display window are not visible, but can be made
  165. so by associated it with a display window.
  166.  
  167. Mode Line
  168.     At the bottom of each display window is the Mode Line associated with
  169. that display window.  The mode line is used to display useful information
  170. related to the text in the display window.  A * appears in the first column of 
  171. the mode line to indicate that the text in the buffer associated with that
  172. display window has been changed since it was last saved.  Next, the mode line
  173. contains the Arexx port name for that invocation of AME. Next comes the name of
  174. the buffer associated with the display window, followed by the file name
  175. associated with that buffer.  Finally are the mode letters, indicating
  176. C mode, Overwrite mode (as opposed to the normal insert mode), Wrap mode
  177. (wrap words at the right margin), Multibyte mode (which supports
  178. the EUC extended character set), Read only mode (the buffer cannot be
  179. changed) and Temporary (AME will replace the contents without asking,
  180. and you can exit with this buffer unsaved).
  181.  
  182. Echo line
  183.     The echo line is used by AME for user input for the various commands.
  184. The echo line supports command completion;  so only enough character to
  185. specify a unique command are required.  Pressing Space and ESC will cause AME
  186. to attempt to complete the command.  If the characters typed so far do not
  187. specify a unique command, AME fills in as many characters as it can, then
  188. calls the system screenbeep routine.  If the REQ AME variable is set, AME will
  189. bring up a requester to collect user input instead.  However, in that case,
  190. command completion is not available.
  191.  
  192. Current Cursor Location    (also known as the dot, or point)
  193.     The Current Cursor Location is the position in the buffer where text will
  194. be entered.
  195.  
  196. Bookmark        (also known as the mark)
  197.     The bookmark is used to define one of the endpoints of a range for
  198. the AME commands that operate on a range within the buffer.
  199.  
  200. Intuition Window
  201.     The Intuition window is the standard Intuition window that AME opens.
  202. This window can be opened on the Workbench screen, or on AME's own custom
  203. screen.
  204.  
  205. MOUSE SUPPORT
  206.  
  207.     The right mouse button brings up the menu system.  A single click
  208. of the left mouse button will move the cursor to that location and 
  209. make that buffer the current buffer).  A double click of the mouse button will 
  210. set the bookmark for the current buffer at that location.  All other mouse
  211. operations are not bound to any function.  Like other 'keys' the left mouse
  212. click and the double click, the shifted mouse click, etc. can be bound to any AME
  213. function, or to Arexx scripts.
  214.  
  215. When there is more than one display window in the AME window, each display window
  216. can be expanded or shrunk by clicking on the mode line, and dragging the
  217. window larger or smaller.  Naturally, this has no effect if there
  218. is only one display window.   NOTE:  the 'Mouse click on mode line' function
  219. can be bound to some other AME operation;  however, the drag operation
  220. only functions for display window resizing.
  221.  
  222.  
  223. WINDOW GADGETS
  224.     The scroller indicates the position within the file.  The scroll
  225. arrows allow you to move the cursor up or down within the file.  (the arrows
  226. do repeat).   The close gadget performs a quit operation.
  227.  
  228.  
  229. ICON SUPPORT (AppWindow support)
  230.     When AME has an Intuition window (has menus, scrollbar, etc) opened on 
  231. the Workbench screen, you can also load files by dragging and dropping 
  232. Workbench icons on the AME window.  AME will create a new buffer and
  233. load your file into the current display window.
  234.  
  235. SPECIAL KEYS 
  236.  
  237. The following are the special keys bound to functions by default.  You are
  238. not limited to these choices.  You are free to rebind the keys to any function
  239. (or Arexx program) you wish.
  240.  
  241. KEY NAME        FUNCTION
  242. -----------------    -------------------------------------------
  243. cursor left         move left one character
  244. cursor right        move right one character
  245. cursor up        move up one line
  246. cursor down        move down one line
  247. shift-cursor left    move to start of current line
  248. shift-cursor right    move to end of current line
  249. shift-cursor up        move to top of current display window
  250. shift-cursor down    move to bottom of current display window
  251. Delete            delete next character
  252. Help            apropos
  253.  
  254. Keypad shift-.        Delete next character
  255. Keypad shift-0        Insert a space at the current cursor location
  256. Keypad shift-1        Move to end of current buffer
  257. Keypad shift-2        Move to next line
  258. Keypad shift-3        Move down one page
  259. Keypad shift-4        Move left one character
  260. Keypad shift-6        Move right one character
  261. Keypad shift-7        Move to top of buffer
  262. Keypad shift-8        Move up one line
  263. Keypad shift-9        Move up one page
  264. ENTER            Insert line
  265.  
  266.  
  267. Getting help
  268.  
  269.     AME has three useful help functions.  The first, APROPOS, is
  270. bound by default to the HELp key (as well as to the ESC ? key combination.)  
  271. This functon allows you to specify a string; AME searches through all the 
  272. command and variable names.  If any of those names contain the string, it 
  273. is added to the list being built by AME.  When the search is complete, AME
  274. displays all the commands found (along with the current key bindings
  275. for that function) in the popup buffer. 
  276.     The second help function is bound to the ^X-? key combination, 
  277. and is called describekey.  When the HELP key is pressed, AME will ask what
  278. key to describe.  You enter this normally, ie ESC X or ^XE , whatever
  279. key or key combination you want.  AME will display the command the key
  280. is bound to, or let you know the key is unbound, and does nothing.
  281. Even the regular alphanumeric keys are bound to a function (called
  282. selfinsert). 
  283.     The third help function is called describebindings.  It will
  284. produce a chart of all keys currently bound to commands other than
  285. selfinsert) and the functions the keys are bound to.  This chart will
  286. be put in the popup buffer, and can be saved and printed for reference
  287. if desired. 
  288.  
  289. Customizing AME
  290.     AME is fully customizable.  The menus are fully reprogrammable,
  291. all the keys can be rebound, new commands added, and a number of
  292. startup options are available. 
  293.  
  294. Most of the general customization commands will be put in the
  295. S:AME_PRO.AME file, which is automatically executed when AME starts.
  296. This file will contain mode settings, function key definitions, menu
  297. definitions, and so on, to make your copy of AME easier to use.  (the
  298. NOSTART keyword allows you to not execute the S:AME_PRO.AME file on
  299. startup.  The WITH keyword allows you to execute an additional file
  300. after the AME_PRO.AME file is (or isn't) executed.  AME looks in the
  301. REXX: directory by default for its script files.
  302.  
  303.     The files are (of course) Arexx script files; so they must
  304. start with an Arexx command (/* */ ) and can be quite complex. 
  305.     The bindkey command is used to assign or change what each key
  306. does; for instance, the bindkey command sets the functions of the
  307. function key.  The following is an example of setting the unshifted
  308. function keys. 
  309.  
  310.  
  311. The shifted function keys can also be set.  (Their names are shift-F1
  312. to shift-F10.  Remember, you can always use the describekey command to
  313. find out the name of any key). 
  314.  
  315. The settings of the AME variables can be changed with the setprefs and
  316. unsetprefs commands.  For instance, to make Arexx go to the Shell
  317. where AME was started, rather than to NIL: (the default), the
  318. following command is used:
  319.  
  320. setprefs rxcom '*'
  321.  
  322. The menu commands can be used to change a couple of the default menu items, add a few extra menu items, or replace the entire default menus.  The menutitle command is used to define a menu tile.  The bar command is used to add a seperator bar.  The item command is used to add another menu item.  And the subitem command is used to add a subitem to a menu item.
  323. Each of the menu commands take a menu slot number.  If the menu slot number is -1, AME will append the menu to the current set of menus.
  324.  
  325. For instance, this adds additional
  326. menus:
  327.  
  328. menutitle '-1 Dice'
  329. item '-1 Dicehelp dcc:arexx/dicehelp.ame'
  330. item '-1 Compile dcc:arexx/compile.ame E' 
  331. item '-1 "Next Error" scc:arexx/nexterror.ame N'
  332. bar -1
  333. item '-1 "Delete paragraph" deleteparagraph'
  334. item '-1 "Justify paragraph" justifyparagraph
  335.  
  336.  
  337. AME AREXX Support
  338.  
  339.     AME has a full Arexx port, with the ability to execute both
  340. Arexx commands and Arexx string files, and to execute commands
  341. received through its Arexx port.  All results from AME execution of
  342. commands received through the port are returned through the Arexx RC
  343. variable and the Arexx RESULT variable.  OPTIONS RESULT should be
  344. placed in any Arexx program talking to AME that expects to receive
  345. results. 
  346.  
  347. The AME result variable can grow to fit whatever output that AME wants
  348. to pass back to the calling Arexx program. 
  349.  
  350. AME uses ReadArgs internally to parse the arguments to its commands.
  351. Because of this, it is best to surround arguments with the '" "'
  352. combination if you have an argument containing spaces.  You have two
  353. goals: keep an argument with spaces as a single unit, and stop Arexx
  354. from capitalizing everything.  The '" combination effectively solves
  355. both problems.  The argument string keyword is -a and is a final
  356. argument (/F).  So you could also specify that name explicitly,
  357. to avoid problems with ReadArgs removal of double quotes.
  358.  
  359. You can pass a numeric argument to one of the AME internal commands
  360. by specifying it with the -n keyword.  
  361.  
  362. The default stdio for Arexx programs started from AME is NIL: This can
  363. be changed by changing the value of the internal AME variable RXCON.
  364. You can change it to * or to something like CON:////REXX/AUTO .
  365. Otherwise you will not see Arexx output that goes to stdio.  Unsetting
  366. this variable returns it to the default state of NIL:
  367.  
  368.  
  369. The ADDRESS internal AME variable allows you to change the port name
  370. that AME sends Arexx commands to.  This portname is usually REXX.
  371. However, you can change it to the port name of another Arexx capable
  372. program, if you want the two programs to communicate directly.
  373. Unsetting this variable returns it to the default state of REXX.
  374. Remember, case is important for port names. 
  375.  
  376.  
  377. COMMAND SUMMARY
  378.  
  379.     The following is a short summary of the commands and variables supported
  380. by AME, and the default bindings for those functions.  Some functions are
  381. unbound, not assigned to any key.  Most of these (with the exception of
  382. the paragraph functions) are mainly for use by Arexx programs, however, they
  383. can be bound to keys if you wish, or used in menus.  Even if a command isn't
  384. bound to a key it may still be invoked by using the 'cmdshell' command and
  385. entering its name.
  386.  
  387.  
  388. Command Name:     setbookmark
  389. Default Key:     ^@  ESC--
  390. Description:     Puts the bookmark for this buffer at the current cursor location.
  391.  
  392. Command Name:    movebol
  393. Default Key:    ^A
  394. Description:    Move the current cursor location to the beginning of the
  395.         current line.
  396.  
  397. Command Name:    moveleft
  398. Default Key:    ^B
  399. Description:    Move the current cursor location back one character.
  400.         (End of line and tabs count each count as one character)
  401.  
  402. Command Name:    quit
  403. Default Key:    ^C   ESC-^C  ^X-^C           
  404. Description:    Check to see if there are any modified buffers.  If there
  405.         are, give the user the option to not exit.  Otherwise exit
  406.         AME.  An argument given to this function indicates a
  407.         "FORCED" quit, and modified buffers will be ignored.
  408.     
  409. Command Name:    delete
  410. Default Key:    ^D
  411. Description:    Delete the character under the cursor
  412.  
  413. Command Name:    moveeol
  414. Default Key:    ^E
  415. Description:    Move the current cursor location to the end of the current line.
  416.  
  417. Command Name:    moveright
  418. Default Key:    ^F
  419. Description:    Move the current cursor location forward one character.
  420.         (End of line and tabs count each count as one character)
  421.  
  422. Command Name:    abort
  423. Default Key:    ^G  ESC-^G
  424. Description:    Abort the current operation
  425.  
  426. Command Name:    deleteprev
  427. Default Key:    ^H
  428. Description:    Delete the character to the left of the current cursor location.
  429.         Deleting a newline character will merge two lines.
  430.  
  431. Command Name:    tab
  432. Default Key:    ^I
  433. Description:    Insert a tab character at the current cursor location.
  434.  
  435. Command Name:    indent
  436. Default Key:    ^J
  437. Description:    Insert a newline, then on the next line, insert enough tabs
  438.         and spaces to move the cursor to the correct indentation level.
  439.         In CMODE this involves checking brace indentation.
  440.  
  441. Command Name:    killline
  442. Default Key:    ^K
  443. Description:    Deletes characters from the current cursor location to the
  444.         end of the line.  If the cursor is at the end of line,
  445.         the newline will be deleted.  Characters deleted by the killine
  446.         command is placed in the kill buffer, and can be retrieved
  447.         by the yank command.  Kills are cumulative;  the first killline
  448.         clears the kill buffer.  As long as only kill commands are
  449.         issued, the text killed is appended to the kill buffer.
  450.  
  451. Command Name:    refresh
  452. Default Key:    ^L
  453. Description:    Clears and redraws the window.
  454.  
  455. Command Name:    insertline
  456. Default Key:    ^M (RETURN)
  457. Description:    Enter a newline character at the current cursor position.
  458.         The newline character is the end of line marker.  The cursor
  459.         advances to the character position after the newline.
  460.  
  461. Command Name:    movedown
  462. Default Key:    ^N
  463. Description:    Move the current cursor location down one line.  An attempt is
  464.         made to keep the cursor in the same column as it started; This
  465.         may not be possible, since the cursor location must be centered
  466.         on a character.
  467.  
  468. Command Name:    openline
  469. Default Key:    ^O
  470. Description:    Inserts a newline at the current cursor location.  The current
  471.         cursor location is left positioned at the start of the just
  472.         opened space.
  473.  
  474. Command Name:    moveup
  475. Default Key:    ^P
  476. Description:    Move the current cursor location up one line.  An attempt is
  477.         made to keep the cursor in the same column as it started; This
  478.         may not be possible, since the cursor location must be centered
  479.         on a character.
  480.  
  481. Command Name:    quote
  482. Default Key:    ^Q
  483. Description:    Enter the next character into the document literally;  
  484.         do not attempt interpret it as an AME command.
  485.  
  486. Command Name:    ifindprev
  487. Default Key:    ^R
  488. Description:    Incremental backward search.
  489.  
  490. Command Name:    ifindnext
  491. Default Key:    ^S
  492. Description:    Incremental forward search.
  493.         Incremental Search is modeled after the incremental search
  494.         mechanism in ITS EMACS.  Incremental search is different from
  495.         the usual search method in that it begins to search before you
  496.         have finished typing the search string.  As the search string is
  497.         entered, AME will show you where in the buffer the string is 
  498.         found.  As soon as you have entered enough characters to 
  499.         identify the place you want, you can stop. 
  500.         
  501.         When incremental search mode is entered, AME will prompt for
  502.         characters; as you type, AME will move the cursor to the first
  503.         occurance of those characters.  If you make a mistake, you can 
  504.         use the delete key...AME will move the cursor back to the 
  505.         previous match of the pattern. 
  506.  
  507.         Entering RETURN will exit incremenal search mode, as does
  508.         entering any command not meaningful during a search (in
  509.         other word, any command other than ^S or ^R).  Typing ^E,
  510.         for instance would exit search mode, and move the cursor to
  511.         the end of the line, as normally. 
  512.  
  513.         When in incremental search mode, typing another ^S will move
  514.         you to the next occurance of the current pattern you
  515.         entered.  ^R will move you back to the previou ocurance of
  516.         the pattern.  You can repeat the previous pattern after
  517.         exiting and reentering incremental search mode by typing a
  518.         ^S immediately on entry to the mode.  ^G cancels the entire 
  519.         search, putting the cursor to where it was before the search 
  520.         began.
  521.  
  522. Command Name:    twiddle
  523. Default Key:    ^T
  524. Description:    Transpose the two characters immediately preceeding the
  525.         current cursor location.
  526.  
  527. Command Name:    universalargument
  528. Default Key:    ^U
  529. Description:    Set an argument number  (negative or positive) for use by the
  530.         next AME command entered.
  531.  
  532. Command Name:    movenextpage
  533. Default Key:    ^V
  534. Description:    Move down one page, so the next page of the buffer is visible
  535.         in the window.
  536.  
  537. Command Name:    deleteblock
  538.         (also known as erase)
  539. Default Key:    ^W              
  540. Description:    Kill (wipe) all characters between the current cursor position
  541.         and the bookmark.  The deleted text is moved to the kill buffer.
  542.  
  543. Command Name:    yank
  544. Default Key:    ^Y              
  545. Description:    Take the contents of the kill buffer and insert it at the
  546.         current cursor location in the current buffer.  The cursor is
  547.         positioned after the inserted text.
  548.  
  549. Command Name:    scrollwindowup
  550. Default Key:    ^Z              
  551. Description:    Reposition the current window on the current buffer up one line.
  552.  
  553. Command Name:    spawn
  554. Default Key:    ^_              
  555. Description:    Open a new Shell.  If AME is operating on its own screen,
  556.         the new Shell will open on the AME window;  otherwise it
  557.         will open on the Workbench window.
  558.  
  559. Command Name:    reposition
  560. Default Key:    ESC-!           
  561. Description:    Repositions the current buffer in the display window.  By default,
  562.         it acts as a 'recenter with current line to top of display window'
  563.         function.  If given a 0 argument, it centers the current line
  564.         in the display window;  if given a positive argument, it positions
  565.         the current line that many lines from the top of the current
  566.         display window;  if given a negative argument, it positions
  567.         the current line that many lines from the bottom of the current
  568.         display window.  (Its purely a visual effect; the text in the
  569.         current buffer is not changed)
  570.  
  571. Command Name:    movebow
  572. Default Key:    ESC-,           
  573. Description:    Move the curent cursor location to the beginning of the
  574.         display window, to the top left corner.
  575.  
  576. Command Name:    moveeow
  577. Default Key:    ESC-.           
  578. Description:    Move the curent cursor location to the beginning of the
  579.         display window, to the bottom left corner.
  580.  
  581. Command Name:    movebob
  582. Default Key:    ESC-<
  583. Description:    Move the current cursor location to the beginning of the
  584.         current buffer.
  585.  
  586. Command Name:    moveeob
  587. Default Key:    ESC->           
  588. Description:    Move the current cursor location to the end of the
  589.         current buffer.
  590.  
  591. Command Name:    apropos
  592.         (also known as help)
  593. Default Key:    ESC-?  or HELP         
  594. Description:    Apropos requests a search string, then scans through all of the
  595.         AME command names for all occurances of your string.  This is
  596.         useful to find all the commands containing move (or window)
  597.         for example.  This scan does not support wildcards;  but will
  598.         find the search string in a command name if the search string
  599.         appears anywhere within the command name.
  600.  
  601. Command Name:     stringrx
  602. Default Key:     ESC-A           
  603. Description:    This command will execute an Arexx string file.  The entire
  604.         argument is passed to Arexx, which attempts to interpret it
  605.         as an Arexx program.  Note:  Unless the RXCON variable is
  606.         set to something other than NIL:, you will not see any 
  607.         console output from the AREXX program.
  608.  
  609. Command Name:     moveprevword
  610. Default Key:     ESC-B
  611. Description:    Move the current cursor location to the beginning of the
  612.         previous word.  If already within a word, moves to the start
  613.         of the word.
  614.  
  615. Command Name:     capital
  616. Default Key:     ESC-C
  617. Description:    Capitalize the current character under the cursor and move to
  618.         the next word.  By using it with an argument, you can
  619.         capitalize more than one word at a time.
  620.  
  621. Command Name:     deletenextword
  622. Default Key:     ESC-D
  623. Description:    Delete characters from the current cursor position to the end of
  624.         the word.  This command lets you kill multiple words
  625.         and stop in a reasonable way when it hits the end of the buffer.
  626.         Words deleted are placed in the kill buffer.
  627.  
  628. Command Name:     rx
  629. Default Key:     ESC-E
  630. Description:    This command executes an Arexx file.  The default extention
  631.         for Arexx files for AME is (of course) .ame .  The rx command
  632.         prompts for the file name.  Arguments given on the echo line 
  633.         with the file name will be passed to the Arexx program as
  634.         its arguments.
  635.  
  636. Command Name:     movenextword
  637. Default Key:     ESC-F
  638. Description:    Move the current cursor location to the end of next word in the
  639.         buffer.
  640.  
  641. Command Name:     deleteprevword
  642. Default Key:     ESC-H
  643. Description:    Delete characters from the current cursor position to the 
  644.         beginning of the word.  The cursor is left on its current
  645.         position.  The character under the cursor is not deleted.
  646.         This command lets you kill multiple words and stop in a 
  647.         reasonable way when it hits the end of the buffer.
  648.         Words deleted are placed in the kill buffer.
  649.  
  650. Command Name:     justifyparagraph          
  651. Default Key:    ESC-J
  652. Description:    Reformat the current paragraph according to the current
  653.         left margin, right margin, indent, and wrap mode.
  654.  
  655. Command Name:    deleteparagraph
  656. Default Key:     ESC-K
  657. Description:    This command will delete characters in the current paragraph 
  658.         from the current cursor location to the end of the paragraph.
  659.         Characters deleted will be placed in the kill buffer, and may
  660.         be retrieved by the yank command.
  661.  
  662. Command Name:     lowercase
  663. Default Key:     ESC-L
  664. Description:    Change from the current character under the cursor to the
  665.         end of word to lower case.  The current cursor location is
  666.         moved to the end of the word.  By using it with an argument, 
  667.         you can change more than one word at a time to lower case.
  668.  
  669. Command Name:     findchange
  670. Default Key:     ESC-Q           
  671. Description:    Changes all occurances of one string to another string, starting
  672.         at the current cursor location and ending at the end of the
  673.         buffer.  AME prompts for the string to find and the string
  674.         to change it to.  If the REGEX variable is set, the search
  675.         string can be a regular expression;  otherwise it is a literal
  676.         string.  The quote command (^Q) can be used in both the search 
  677.         string and the replacement string to search or replace
  678.         control characters.  AME remembers the search string from
  679.         one search to the next. For each occurance of the string found,
  680.         AME allows the user to determine if the change should be made
  681.         (space), don't change and continue the search (n), change
  682.         this occurance and all others without asking further (c),
  683.         change this one and stop (. or ESC), stop immediately 
  684.         (without changing this one) (^G), anything else will list 
  685.         the options available.  Because the regular expression search
  686.         is slower than the standard search, findchange will automatically
  687.         switch to the standard search if no wild cards are used in the
  688.         search string.
  689.  
  690. Command Name:     findreplace
  691. Default Key:     ESC-R
  692. Description:    Changes all occurances of one string to another string, starting
  693.         at the current cursor location and ending at the end of the
  694.         buffer.  AME prompts for the string to find and the string
  695.         to change it to.  If the REGEX variable is set, the search
  696.         string can be a regular expression;  otherwise it is a literal
  697.         string.  The quote command (^Q) can be used in both the search 
  698.         string and the replacement string to search or replace
  699.         control characters.  AME remembers the search string from
  700.         one search to the next. AME changes each occurance of the 
  701.         search string to the replacement string.  Because the regular 
  702.         expression search is slower than the standard search, findreplace
  703.         will automatically switch to the standard search if no wild 
  704.         cards are used in the search string.
  705.  
  706. Command Name:     setprefs
  707. Default Key:     ESC-S
  708. Description:    This command is used to set one or more of the internal AME
  709.         variables which controls the behavior of some of the commands.
  710.         The variables supported are:
  711.  
  712.         ADDRESS    BACKUP    BEEP    CASE    CHECK    CMODE   CONWAIT 
  713.         EOL    FOLDS     FREQ    ICONS    INDENT    LEFT    MBYTE
  714.         MODE    OVER    PROJECT    READ    REGEX    REQ    RIGHT
  715.          RXCON     SCORE    TAB    TEMP    UNDO    USTEPS    WRAP     
  716.         VAR
  717.  
  718.         See the AME Variables section for additional information on
  719.         the variables and functions.
  720.  
  721. Command Name:     uppercase
  722. Default Key:     ESC-U
  723. Description:    Change from the current character under the cursor to the
  724.         end of word to upper case.  The current cursor location is
  725.         moved to the end of the word.  By using it with an argument, 
  726.         you can change more than one word at a time to upper case.
  727.  
  728. Command Name:     moveprevpage
  729. Default Key:     ESC-V
  730. Description:    Move up one page, so the previous page of the buffer is visible
  731.         in the window.
  732.  
  733. Command Name:     copyblock
  734. Default Key:     ESC-W
  735. Description:    Copy all characters from the bookmark set in the current
  736.         buffer to the current cursor location in the buffer to 
  737.         the Amiga clipboard.device.
  738.  
  739. Command Name:     scrollwindowdown
  740. Default Key:     ESC-Z
  741. Description:    Reposition the current window on the current buffer down one line.
  742.  
  743. Command Name:     swapcase
  744. Default Key:     ESC-^
  745. Description:    Invert the case of all characters between the current cursor
  746.         location and the end of the current word.
  747.  
  748. Command Name:     deleteprevword
  749. Default Key:     ESC-Del
  750. Description:    Delete characters from the current cursor position to
  751.         the beginning of the current word.    
  752.  
  753. Command Name:     bindkey
  754. Default Key:     ESC-^B
  755. Description:    This command allows the user to change the current key bindings;
  756.         key bindings are which command is executed when each key is hit.
  757.         The bindkey command prompts for the function to bind (with
  758.         command completion), the key to bind, and any optional 
  759.         arguments for the function.  If you already have the function 
  760.         bound, this new binding is in addition to the old binding;  
  761.         the old binding is still in effect.  Only the key you are binding
  762.         is affected.  Almost all keys can be bound, as well as the mouse,
  763.         with a variety of qualifiers.  The keypad can be bound seperately.
  764.  
  765.         When binding keys in a script file, you must use the
  766.         key names.  Do not use the quote (^Q) function to
  767.         enter the ESC or ^X.  Instead, spell it out, ie
  768.         use ESC-  or ^X-  (or ESC or ^X).  The same goes for
  769.         control characters.  For example, to rebind the search
  770.         and incremental search commands in your ame_pro.ame file,
  771.         you would include the following statements:
  772.  
  773.         bindkey "find ^S"
  774.         bindkey "findprev ^R"
  775.         bindkey "ifindnext ^XS"
  776.         bindkey "ifindprev ^X-R"
  777.  
  778.         In general, you should use the same information displayed 
  779.         when you use describekey on a bound key or in the chart
  780.         producted by the describebindings command.
  781.  
  782.  
  783.         The bindable keys are as follows:
  784.  
  785.     KEYNAME            Keys available to bind        AME qualifiers
  786.     -------            ----------------------        --------------
  787.     F1-F10            unshifted, shifted
  788.     HELP            unshifted
  789.     DEL            unshifted
  790.     SPACE            unshifted, alt
  791.     CURSOR KEYS        unshifted, shifted
  792.     TAB            unshifted (same as ^I)         ^X, ESC    
  793.     BACKSPACE        unshifted (same as ^H)         ^X, ESC    
  794.     All keys on keypad    unshifted, shifted         ^X, ESC
  795.     All alphanumeric keys    unshifted, shifted, alt, ctrl     ^X, ESC
  796.     Mouse Click        on mode line :
  797.                     unshifted, shifted, alt, ctrl
  798.                 on echo line:
  799.                     unshifted, shifted, alt, ctrl
  800.                 in display window
  801.                     unshifted, shifted, alt, ctrl
  802.  
  803.  
  804. Command Name:     movematchbkt
  805. Default Key:     ESC-^F
  806. Description:    Moves the cursor to the matching brace, bracket, or parenthesis.
  807.         When searching for a member of a pair ({} or () or <> or [])
  808.         search direction is automatic.  This command can also be used 
  809.         to find matching quotes. In this case, the command defaults to 
  810.         searching forward;  to search backwards, a negative argument 
  811.         is used.
  812.  
  813. Command Name:     lowercaseblock
  814. Default Key:     ESC-^L
  815. Description:    Changes all the characters from the bookmark set in the current
  816.         buffer to the current cursor position to lower case.  
  817.         The cursor position is left unchanged.
  818.  
  819. Command Name:     unsetprefs
  820. Default Key:     ESC-^S
  821. Description:    This command is used to unset any of the internal AME variables
  822.         that can be set by the setprefs command.  In the case of the
  823.         RXCON and ADDRESS variables, unset means return to default
  824.         values of NIL: and AREXX.
  825.  
  826. Command Name:     uppercaseblock
  827. Default Key:     ESC-^U
  828. Description:    Changes all the characters from the bookmark set in the current
  829.         buffer to the current cursor position to upper case.  
  830.         The cursor position is left unchanged.
  831.  
  832.  
  833. Command Name:     moveothernextpage
  834. Default Key:     ESC-^V
  835. Description:    Move the next window down one page, so the next page of that 
  836.         buffer is visible in that window.
  837.  
  838. Command Name:     writeblock
  839. Default Key:     ESC-^W
  840. Description:    Write the characters from the bookmark set in the current
  841.         buffer to the current cursor position to a file.  AME will
  842.         prompt for the file name.  If the REQFLAG or FREQ variables
  843.         are set, the asl.library file requester will appear;  otherwise
  844.         the file name must be entered in the echo line.
  845.         
  846. Command Name:     cmdshell
  847. Default Key:     ESC-ESC  or ESC-^[
  848. Description:    This command will execute an extended command.  The command
  849.         is entered in the echo line with command completion.  You can
  850.         enter ESC or space to invoke the command completer.
  851.  
  852. Command Name:     spawncommand
  853. Default Key:     ^X-!
  854. Description:    Spawncommand prompts for a command to execute.  This is passed
  855.         to AmigaDOS to execute.  Normal output from the command will be
  856.         placed in the popup buffer.  (Error output will appear in
  857.         the Shell AME was invoked from).
  858.  
  859. Command Name:     startmacro
  860. Default Key:     ^X-(
  861. Description:    All the keys entered following this command will be stored
  862.         in the keyboard macro buffer, for later use.
  863.         Incremental search cannot be executed as a macro, due to
  864.         limitations in the macro processor that may be removed
  865.         in a later version of AME.  If a search is required, the
  866.         non-incremental search must be used.
  867.  
  868. Command Name:     stopmacro
  869. Default Key:     ^X-)
  870. Description:    Stop storing keys in the keyboard macro buffer.
  871.  
  872. Command Name:     onlywindow
  873. Default Key:     ^X-1
  874. Description:    Remove all display windows except the current display
  875.         window, which becomes full size.
  876.  
  877. Command Name:    splitwindow
  878. Default Key:     ^X-2
  879. Description:    Split the current display window into two display windows,
  880.         dividing the space available between the two display windows.
  881.  
  882. Command Name:     describekey
  883. Default Key:     ^X-?
  884. Description:    AME will ask for the key to describe.  The key (or key 
  885.         combination) should be typed in exactly as it would be
  886.         typed to execute it.  AME will then display the current
  887.         command binding of that key, or say the key is not
  888.         bound.  To find out the current binding of ^XD, invoke
  889.         the discribekey command, then type control X D.  AME will
  890.         display the current binding.  This function works for all
  891.         bindable keys, including mouse clicks.
  892.  
  893. Command Name:     displayposition
  894. Default Key:     ^X-=
  895. Description:    This command will display information about the current
  896.         cursor location including the current character under the
  897.         cursor, the line number within the buffer, the original
  898.         line number (the ID) of the line as it was loaded from a file
  899.         (unaffected by later line additions or deletions), The row 
  900.         within the current display window, the column within the 
  901.         current display window, and the position within the buffer, as 
  902.         a percentage of total number of characters in the buffer.
  903.         This string is also copied to the Arexx result string.
  904.  
  905. Command Name:    findagain
  906. Default Key:     ^X-A
  907. Description:    This command will repeat the last find operation.
  908.  
  909. Command Name:     usebuffer
  910. Default Key:     ^X-B            
  911. Description:    Ask for the name of the buffer, and link it to the current
  912.         display window.  The old buffer is merely unlinked from
  913.         the display window.  It is not erased or changed in any way.
  914.         If the requested buffer does not exist, a new buffer with that
  915.         name will be created.
  916.  
  917. Command Name:    vcopyblock
  918. Default Key:    ^X-C
  919. Description:    This command copies a block in the vertical current column
  920.         defined by the mark and the current cursor position and puts
  921.         it into the kill buffer.  A vertical column should be
  922.         pasted into a document with the vyank command to keep
  923.         it in a column.
  924.  
  925. Command Name:     deletewindow
  926. Default Key:     ^X-D
  927. Description:    Delete the current display window, and enlarge either the 
  928.         display window below or the display window above the current 
  929.         display window to fill in the space.  If there is only one 
  930.         display window, nothing happens.
  931.  
  932. Command Name:     executemacro
  933. Default Key:     ^X-E
  934. Description:    This command takes the keys stored with the startmacro command
  935.         and treats them as if they were typed again.
  936.         Incremental search commands cannot be executed from a keyboard
  937.         macro.
  938.  
  939. Command Name:     setfilepath
  940. Default Key:     ^X-F
  941. Description:     Change the name of the file associated with the current buffer.
  942.         This is the name that will be used when the current buffer 
  943.         is saved.
  944.  
  945. Command Name:     gotoidline
  946. Default Key:     ^X-G
  947. Description:    Prompt for the line ID to go to, and move the current cursor 
  948.         location to that line.  Line IDs are sequentially assigned 
  949.         to each line as the file is loaded.  This ID represents the
  950.         original line number, before any insertions or deletions.
  951.  
  952. Command Name:    insertbuffer
  953. Default Key:    ^X-I
  954. Description:    This command will prompt for the name of the buffer to insert,
  955.         then inserts it at the current cursor location in the current
  956.         buffer.
  957.  
  958. Command Name:     jump
  959. Default Key:     ^X-J
  960. Description:    AME will ask for the name of the public screen to jump the
  961.         Intuition window.  Just pressing return will cause the AME
  962.         window to jump to the next public screen.  If there is only
  963.         one public screen (and AME is on it) nothing will happen.
  964.         If a public screen name is given, AME will jump to that screen.
  965.         If the screen name is mistyped or doesn't exist an error
  966.         will be reported.
  967.  
  968. Command Name:    killbuffer
  969. Default Key:    ^X-K            
  970. Description:    Prompt for a buffer name, and delete that buffer.  All the
  971.         text in that buffer will be erased.  This command
  972.         will fail if the buffer is being displayed.
  973.  
  974. Command Name:    nextwindow
  975. Default Key:     ^X-N
  976. Description:    Switch to the display window below the current display window.
  977.         If the current display window is the lowest, the top display
  978.         window will be made active.
  979.  
  980. Command Name:     useoldbuffer
  981. Default Key:     ^X-O   
  982. Description:    Ask for the name of the old buffer and link it to the current
  983.         window.  The old buffer linked to the window is not affected
  984.         in any way.  The buffer to be displayed must already exist.
  985.  
  986. Command Name:     prevwindow
  987. Default Key:     ^X-P
  988. Description:    Switch to the display window above the current display window.
  989.         If the current display window is the highest, the bottom display
  990.         window will be made active.
  991.  
  992. Command Name:    vdeleteblock
  993. Default Key:    ^X-W
  994. Description:    This command cuts a block in the vertical current column
  995.         defined by the mark and the current cursor position and puts
  996.         it into the kill buffer.  A vertical column should be
  997.         pasted into a document with the vyank command to keep
  998.         it in a column.
  999.  
  1000. Command Name:    vyank
  1001. Default Key:    ^X-Y
  1002. Description:    This command is used to enter the text from the kill buffer
  1003.         into the current buffer at the current cursor position
  1004.         in a column.
  1005.  
  1006. Command Name:     findprev
  1007. Default Key:     ESC-^R
  1008. Description:    Search backwards for the next occurance of a string.  AME
  1009.         prompts for the string to search for;  if the REGEX flag is
  1010.         set, regular expressions may be used;  otherwise the text
  1011.         is treated literally.  The quote command (^Q) may be used
  1012.         to enter control characters into the search string;  this
  1013.         allows end of line to be searched (end of line is ^J).
  1014.         AME remembers the search string from one search to the next,
  1015.         and displays it in the prompt.  Hitting the return key will 
  1016.         retain the same search string.
  1017.         
  1018. Command Name:     find
  1019. Default Key:     ESC-^S
  1020. Description:    Search forwards for the next occurance of a string.  AME
  1021.         prompts for the string to search for;  if the REGEX flag is
  1022.         set, regular expressions may be used;  otherwise the text
  1023.         is treated literally.  The quote command (^Q) may be used
  1024.         to enter control characters into the search string;  this
  1025.         allows end of line to be searched (end of line is ^J).
  1026.         AME remembers the search string from one search to the next,
  1027.         and displays it in the prompt.  Hitting the return key will 
  1028.         retain the same search string.
  1029.         The regular expressions are the standard AmigaDOS regular
  1030.         expressions, with one addition:  The ^ character can be used
  1031.         to anchor the search to either the beginning and/or to the end
  1032.         of lines.  The ^ character only has this special meaning
  1033.         when used at the beginning or end of the search string.  
  1034.         A leading or trailing space will allow you to use a ^ as a ^
  1035.         at the beginning or end of the search string.
  1036.         The regular expression search is limited to lines shorter
  1037.         than 2048 bytes;  only the first 2048 bytes will be
  1038.         searched.  If you have lines longer than 2048 bytes, you
  1039.         should turn REGEX off.
  1040.         Regular expression search is noticably slower than
  1041.         standard search.  This is especially noticable in
  1042.         findchange, and findreplace.
  1043.         Amiga regular expression give powerful search capabilities 
  1044.         to the find commands.  The following regular expression tokens 
  1045.         are supported:
  1046.  
  1047.         ?     matches a single character # matches the next 
  1048.             expression 0 or more times 
  1049.         (ab|cd) matches any one of the items seperated by the | character 
  1050.         ~     negates the sense of the next token or expression 
  1051.         [abc]    matches any of the characters defined in the character 
  1052.             class.  
  1053.         a-z    defines a character range, to use within a character 
  1054.             class definition.
  1055.         %     matches 0 characters (for example, (ab|cd|%) 
  1056.         ^     anchor to beginning or end of line. 
  1057.  
  1058.         Expressions can be combined.  The most commonly used expression 
  1059.         is #?, which matches any number of characters. 
  1060.         
  1061. Command Name:     togglewindow
  1062. Default Key:     ^X-T
  1063. Description:    Toggle between an AME window on the Workbench screen, and
  1064.         AME opening its own public screen and putting its window
  1065.         there.  Only when AME is open on the Workbench screen does
  1066.         it have a scroll bar.
  1067.  
  1068. Command Name:     moveothernextpage
  1069. Default Key:     ^X-V
  1070. Description:    Move the next window up one page, so the previous page of that 
  1071.         buffer is visible in that window.
  1072.  
  1073. Command Name:     deletewhitespace
  1074. Default Key:     ^X-W
  1075. Description:    Delete all the white space (spaces and tabs) surrounding the
  1076.         current cursor location.
  1077.  
  1078. Command Name:     enlargewindow
  1079. Default Key:     ^X-Z
  1080. Description:    Make the current display window one line larger and the 
  1081.         display window below one line shorter.  If there is no 
  1082.         display window below, a line is taken from the window above.
  1083.  
  1084. Command Name:     movebop
  1085. Default Key:     ^X-[
  1086. Description:    Move the current cursor location to the beginning of the
  1087.         current paragraph.
  1088.  
  1089. Command Name:     moveeop
  1090. Default Key:     ^X-]           
  1091. Description:    Move the current cursor location to the end of the
  1092.         current paragraph.
  1093.  
  1094. Command Name:     displaybuffers
  1095. Default Key:     ^X-^B           
  1096. Description:    Pop up the information about currently active buffers in the
  1097.         temporary popup display window.  For each buffer currently
  1098.         in use, AME will display a line containing the name of the
  1099.         buffer, its size, what file the buffer is associated with,
  1100.         and whether the buffer has been changed since loading.
  1101.  
  1102. Command Name:     deleteline
  1103. Default Key:     ^X-^D
  1104. Description:    Delete the current line and close up the space it occupied.
  1105.         The current cursor location will be moved to the beginning
  1106.         of the next line.  The text deleted is placed in the kill
  1107.         buffer.
  1108.  
  1109. Command Name:     quickexit
  1110. Default Key:     ^X-^F
  1111. Description:    Save all modified buffers and exit AME.
  1112.  
  1113. Command Name:     gotoline
  1114. Default Key:     ^X-^G
  1115. Description:    Ask for a line number, and move the current cursor location 
  1116.         to the beginning of that line if it exists.
  1117.  
  1118. Command Name:     insertfile
  1119. Default Key:     ^X-^I
  1120. Description:    Ask for the name of a file to insert, and insert the contents
  1121.         of the file at the current cursor location.  If either the FREQ
  1122.         or REQ variable is set, then the asl library file requester
  1123.         will be brought up for file selection.
  1124.  
  1125. Command Name:     savemodified
  1126. Default Key:     ^X-^M
  1127. Description:    Save all modified buffers under the file names associated with
  1128.         each changed buffer.
  1129.  
  1130. Command Name:     deleteblanklines
  1131. Default Key:     ^X-^O
  1132. Description:    Delete all blank lines above and below the current blank line.
  1133.         If the current line is not blank, nothing is deleted.
  1134.  
  1135. Command Name:     popbuffer  
  1136. Default Key:     ^X-^P
  1137. Description:    AME will ask for the name of the buffer;  that buffer
  1138.         will appear in one of the current display window. If there
  1139.         is only one display window, it will be split to make room.
  1140.  
  1141. Command Name:    open
  1142. Default Key:    ^X-^R
  1143. Description:    Asks for a file name, then read the file into the current
  1144.         buffer.  If the current buffer contains unsaved, modified
  1145.         text, then AME asks if the changes should be discarded and
  1146.         the file loaded.  If the REQ variable or the FREQ variable is
  1147.         set, the asl file requester is used to select the file to
  1148.         load.  Otherwise AME asks for the name of the file to load in
  1149.         the echo line.
  1150.  
  1151. Command Name:     save
  1152. Default Key:     ^X-^S
  1153. Description:    Save the current buffer (if it has been modified) under the
  1154.         file name currently associated with the buffer.  If the
  1155.         buffer has no name, AME will complain.
  1156.  
  1157. Command Name:     undo
  1158. Default Key:     ^X-^U
  1159. Description:    If the UNDO variable is set, this command will undo the last
  1160.         change made to the buffer.
  1161.         NOTE: this function does not work completely at this time;
  1162.         it does not correctly undo deleted blank lines.
  1163.  
  1164. Command Name:     visit
  1165. Default Key:     ^X-^V
  1166. Description:    Ask for the name of a file, then switch to the the buffer
  1167.         which contains it.  If no buffer contains a file with that
  1168.         name, AME will switch to a new buffer (named the same as
  1169.         the file name), and load the file.  If there is already a 
  1170.         buffer with that name that does not contain the correct
  1171.         file AME will ask if the buffer should be overwritten
  1172.         before loading.  Like other file I/O commands, visit
  1173.         uses the asl file requester if either the REQ variable or
  1174.         the FREQ variable is set.
  1175.  
  1176. Command Name:     saveas
  1177. Default Key:     ^X-^W
  1178. Description:    Asks for the name to use, then saves the current buffer
  1179.         to that name.  The file name associated with the current
  1180.         buffer is automatically changed to the name used to save
  1181.         under.  Like other file I/O commands, saveas
  1182.         uses the asl file requester if either the REQ variable or
  1183.         the FREQ variable is set.
  1184.  
  1185. Command Name:     gotobookmark
  1186. Default Key:     ^X-^X
  1187. Description:    Moves the current cursor location to the bookmark
  1188.         set in the current buffer, and moves the bookmark to
  1189.         the where the cursor position was.
  1190.  
  1191. Command Name:     shrinkwindow
  1192. Default Key:     ^X-^Z
  1193. Description:    Make the current display window one line smaller and the 
  1194.         display window below one line larger.  If there is no 
  1195.         display window below, a line is given to the display window above.
  1196.  
  1197. Command Name:    insertcharacter
  1198. Default Key:    KEYPAD 0
  1199. Description:    Insert a space at the current character position.  This is
  1200.         especially useful when editing a document in OVERWRITE mode.
  1201.  
  1202. Command Name:    spaceinsert
  1203. Default Key:    Shift-KP0
  1204. Description:    Insert a space at the current cursor position.  This is
  1205.         useful when in overstrike mode, to allow you to insert
  1206.         characters without leaving the mode.
  1207.  
  1208.  
  1209.  
  1210.  
  1211. Command Name:    activatewindow
  1212. Default Key:     UNBOUND
  1213. Description:    Activate the AME Intuition Window
  1214.  
  1215. Command Name:     bar
  1216. Default Key:     UNBOUND
  1217. Description:    Put a menu bar into the menu.  AME will ask for the menu slot
  1218.         where the menu bar should be placed.  Menus are automatically
  1219.         disabled when this command is used.  (This speeds up adding
  1220.         multiple menu items and bars to the menu). The onmenu command 
  1221.         is used to activate the menu system.  If -1 is used for the
  1222.         menu slot, the bar is appended to the end of the current menu
  1223.         list.  
  1224.  
  1225. Command Name:     bindsymbol
  1226. Default Key:     UNBOUND
  1227. Description:    This command is used to create a new AME command.  The command
  1228.         is either an Arexx script file or an Arexx string command.  AME
  1229.         will prompt for the name for the new symbol, the type
  1230.         (string or file), and the arguments.  In the case of a string
  1231.         file, this will be the entire command to execute.  In the case
  1232.         of an Arexx script file, the argument will be the name of the
  1233.         file to execute, as well as any arguments that must be passed
  1234.         to the script. 
  1235.  
  1236. Command Name:     beepscreen
  1237. Default Key:     UNBOUND
  1238. Description:    Flash the screen.
  1239.  
  1240. Command Name:     clear      
  1241. Default Key:     UNBOUND
  1242. Description:    This command will clear the current buffer.  If there are 
  1243.         unsaved changes, AME will ask for verification before
  1244.         proceeding.
  1245.  
  1246. Command Name:    closewindow
  1247. Default Key:    CloseGadget
  1248. Description:    This command will bring up a 'changed' requester if the document
  1249.         has changed.  If the user clicks OK, the command attempts
  1250.         to quit the program.
  1251.  
  1252. Command Name:     copy
  1253. Default Key:     UNBOUND         
  1254. Description:    This command will copy the characters from the bookmark set
  1255.         in the current buffer to the current cursor position into
  1256.         unit 0 of the Amiga clipboard.device.  This command is usually
  1257.         placed in the EDIT menu, with its shortcut key set to C,
  1258.         following the style guide.
  1259.  
  1260. Command Name:     copykill
  1261. Default Key:     UNBOUND         
  1262. Description:    This command will copy the characters from kill buffer into
  1263.         unit 0 of the Amiga clipboard.device.
  1264.  
  1265. Command Name:     cut
  1266. Default Key:     UNBOUND
  1267. Description:    This command will delete the characters from the bookmark set
  1268.         in the current buffer to the current cursor position and place
  1269.         those characters into unit 0 of the Amiga clipboard.device.  
  1270.         This command is usually placed in the EDIT menu, with its 
  1271.         shortcut key set to X, following the style guide.
  1272.  
  1273. Command Name:     describebindings
  1274. Default Key:     UNBOUND         
  1275. Description:    This command will produce a listing of all current key bindings
  1276.         in the popup buffer.  This list can be saved and printed
  1277.         as a reference.
  1278.  
  1279. Command Name:     displayversion
  1280. Default Key:     UNBOUND
  1281. Description:    This command will display the version information for AME.
  1282.  
  1283. Command Name:     dottomouse
  1284. Default Key:     UNBOUND
  1285. Description:    This command calculate the position where the mouse
  1286.         was when the left button was last clicked and attempt
  1287.         to move the current cursor location to that position,
  1288.         if the button was clicked when the mouse cursor was
  1289.         over the display window area.  This could result in a different
  1290.         display window becoming active, or the cursor moving within
  1291.         a display window.  This command is usually used by Arexx programs
  1292.         bound to the mouse which need to move the cursor or select
  1293.         a display window before further operations.
  1294.  
  1295. Command Name:     endmenu
  1296. Default Key:     UNBOUND
  1297. Description:    AME will ask where to place the end of menu marker.  This
  1298.         marker indcates the end slot of the current AME menus.  An
  1299.         end marker must be present for the menus to appear.
  1300.         Use of this command automatically disables the AME menus.
  1301.         They must be reactivated with the onmenu command.
  1302.  
  1303. Command Name:    font
  1304. Default Key:    UNBOUND
  1305. Description:    Set the font for the text.  If either REQ or FREQ is set
  1306.         (and you are using V38 or higher) the asl.library font
  1307.         requester will be used;  otherwise the font name
  1308.         and size is entered in the echo line.
  1309.  
  1310. Command Name:     fenceinsert
  1311. Default Key:     UNBOUND    
  1312. Description:    This command inserts the fence character passed to it
  1313.         with appropriate fence matching.  Fence matching is
  1314.         normally done automatically, in CMODE, when a close
  1315.         brace, parenthesis, or bracket is typed.  You can bind
  1316.         any key to fenceinsert, however.  If the key
  1317.         is a member of a bracket pair, the match will
  1318.         be with the other member of the pair;  otherwise
  1319.         it will match with itself.  The fenceinsert command
  1320.         is a selfinsert like command; it inserts the key struck.
  1321.         To override that, the -k argument must be used.
  1322.         For instance, a useful     binding would be to bind F10 to the 
  1323.         fenceinsert function, with an argument of -k 34  .  Every time 
  1324.         the F10 key is hit, it would do a fenceinsert on the character
  1325.         number 34 (the double quotes).  
  1326.         
  1327. Command Name:    foldblock
  1328. Default Key:    UNBOUND
  1329. Description:    This command folds (removes from view) the currently
  1330.         selected block.  The lines folded are still present,
  1331.         and may be temporarily displayed with the show command.
  1332.         The unfold command undo the effects of the fold command.
  1333.         The first line of the block is not folded;  instead, it
  1334.         is displayed with a leading @ sign.  If a fold is folded in
  1335.         another fold block, the folds nest.  If mark (which defines
  1336.         a block) is at the current cursor position, AME will fold
  1337.         all lines with a greater indentation than the current line.
  1338.         Folds are saved on a file by file basis when the FOLDS flag 
  1339.         is set, in a  file with the extension .FLD  .  If a file 
  1340.         contains no folds, no .FLD file is created.
  1341.  
  1342. Command Name:    foldfunction
  1343. Default Key:    UNBOUND
  1344. Description:    This command folds a C function.  It looks at the indentation
  1345.         level of the next line containing a { (including the initial
  1346.         line), and folds lines until a line with the same or less
  1347.         indentation level is encountered.  If a fold is folded into 
  1348.         another block, the folds nest.
  1349.  
  1350. Command Name:    getblockinfo
  1351. Default Key:     UNBOUND
  1352. Description:    This command will return the currently selected
  1353.         region in the Arexx result string.  The region is defined by
  1354.         the bookmark set in the current buffer and the current
  1355.         cursor position.  If the bookmark is set, the row, column,
  1356.         and number of characters in the region is returned.
  1357.  
  1358. Command Name:     getbuffername
  1359. Default Key:     UNBOUND
  1360. Description:    This command will return the name of the current buffer
  1361.         in the Arexx result string.
  1362.  
  1363. Command Name:     getchar
  1364. Default Key:     UNBOUND
  1365. Description:    This command will return the character under the cursor in
  1366.         the Arexx result string.
  1367.  
  1368. Command Name:     getcurrentdir
  1369. Default Key:     UNBOUND
  1370. Description:    This command returns the full path name of the current
  1371.         directory associated with the current buffer in the 
  1372.         Arexx result string.
  1373.  
  1374. Command Name:     getcursorpos
  1375. Default Key:     UNBOUND
  1376. Description:    This command returns the row and column of the current
  1377.         cursor position, and a YES if the line is first line
  1378.         of a fold or a NO otherwise, in the Arexx result string.
  1379.  
  1380. Command Name:    getdwinfo
  1381. Default Key:    UNBOUND
  1382. Description:    This command returns the number of display windows currently
  1383.         open, and the buffer names associated with each window.  The
  1384.         buffers are in order, from the top buffer in the window, to
  1385.         the lowest.
  1386.  
  1387. Command Name:     getfilename              
  1388. Default Key:     UNBOUND         
  1389. Description:    This command returns the file name associated with the
  1390.         current buffer in the Arexx result string.
  1391.  
  1392. Command Name:     getfilepath              
  1393. Default Key:     UNBOUND         
  1394. Description:    This command returns the file path, including the file name,
  1395.         associated with the current buffer in the Arexx result string.
  1396.         This file path can be relative to the current directory
  1397.         set in AME.
  1398.  
  1399. Command Name:     getfullpath
  1400. Default Key:     UNBOUND
  1401. Description:    This command returns the fully qualified file path, including
  1402.         the file name, associated with the current buffer in the
  1403.         Arexx result string.
  1404.  
  1405. Command Name:     getline
  1406. Default Key:     UNBOUND
  1407. Description:    This command returns the contents of the current line in the
  1408.         Arexx result string.
  1409.  
  1410. Command Name:     getmousepos
  1411. Default Key:     UNBOUND
  1412. Description:    This command returns the row and column of the last position
  1413.         the left mouse button was clicked in the Arexx result string.
  1414.  
  1415. Command NameL    getlastpattern
  1416. Default Key:    UNBOUND
  1417. Description:    This command returns the last pattern used in a search
  1418.         routine.
  1419.  
  1420. Command Name:    getprefs
  1421. Default Key:    UNBOUND
  1422. Description:    This command is used to get the current values of
  1423.         the internal AME variables.  The requested values are printed
  1424.         in the echo line as well as returned in the Arexx result string.
  1425.  
  1426. Command Name:    getrxkey
  1427. Default Key:    UNBOUND
  1428. Description:    This command is used to get the hexadecimal value of the key that
  1429.         invoked an Arexx script.  This is used if the macro
  1430.         needs to know what key was used to start it.  The key returned
  1431.         as a number in the Arexx result string.  The following table
  1432.         can be used to decode the value:
  1433.  
  1434.         MASK        Description
  1435.         ----        ------------------------
  1436.         0x000-0x0FF    The basic character code for normal characters
  1437.         0x100-0x1FF    Special Characters
  1438.                 0x100    Special No Key
  1439.                 0x101    Cursor Up
  1440.                 0x102    Cursor Down
  1441.                 0x103    Cursor left
  1442.                 0x104    Cursor right
  1443.                 0x105    Shift cursor up
  1444.                 0x106    Shift cursor down
  1445.                 0x107    Shift cursor left
  1446.                 0x108    Shift cursor right
  1447.                 0x109    HELP
  1448.                 0x10A    MENU event
  1449.                 0x10B    Resize event
  1450.                 0x10C    F1
  1451.                 0x10D    F2
  1452.                 0x10E    F3
  1453.                 0x10F    F4
  1454.                 0x110    F5
  1455.                 0x111    F6
  1456.                 0x112    F7
  1457.                 0x113    F8
  1458.                 0x114    F9
  1459.                 0x115    F10
  1460.                 0x116    Shift F1
  1461.                 0x117    Shift F2
  1462.                 0x118    Shift F3
  1463.                 0x119    Shift F4
  1464.                 0x11A    Shift F5
  1465.                 0x11B    Shift F6
  1466.                 0x11C    Shift F7
  1467.                 0x11D    Shift F8
  1468.                 0x11E    Shift F9
  1469.                 0x11F    Shift F10
  1470.                 0x120    Mouse Click
  1471.                 0x121    Control Mouse Click
  1472.                 0x122    Shift Mouse Click
  1473.                 0x123    Control Shift Mouse Click
  1474.                 0x124    ALT Mouse Click
  1475.                 0x125    Control ALT Mouse Click
  1476.                 0x126    Shift ALT Mouse Click
  1477.                 0x127    Control Shift ALT Mouse Click
  1478.  
  1479.                 0x128    Mouse Click on mode line
  1480.                 0x129    Control Mouse Click on mode line
  1481.                 0x12A    Shift Mouse Click on mode line
  1482.                 0x12B    Control Shift Mouse Click on mode line
  1483.                 0x12C    ALT Mouse Click on mode line
  1484.                 0x12D    Control ALT Mouse Click on mode line
  1485.                 0x12E    Shift ALT Mouse Click on mode line
  1486.                 0x12F    Control Shift ALT Mouse Click on mode line
  1487.  
  1488.                 0x130    Mouse Click on echo line
  1489.                 0x131    Control Mouse Click on echo line
  1490.                 0x132    Shift Mouse Click on echo line
  1491.                 0x133    Control Shift Mouse Click on echo line
  1492.                 0x134    ALT Mouse Click on echo line
  1493.                 0x135    Control ALT Mouse Click on echo line
  1494.                 0x136    Shift ALT Mouse Click on echo line
  1495.                 0x137    Control Shift ALT Mouse Click on echo line
  1496.  
  1497.                 0x140    Mouse Click at display window top
  1498.                 0x141    Control Mouse Click at display window top
  1499.                 0x142    Shift Mouse Click at display window top
  1500.                 0x143    Control Shift Mouse Click at 
  1501.                     display window top
  1502.                 0x144    ALT Mouse Click at display window top
  1503.                 0x145    Control ALT Mouse Click at display
  1504.                     window top
  1505.                 0x146    Shift ALT Mouse Click at top of 
  1506.                     display window
  1507.                 0x147    Control Shift ALT Mouse Click at top 
  1508.                     of display window
  1509.                 0x148    Keypad Left Parenthesis
  1510.                 0x149    Keypad Right Parenthesis
  1511.                 0x14A    Keypad Asterisk
  1512.                 0x14B    Keypad Plus
  1513.                 0x14C    Keypad ENTER
  1514.                 0x14D    Keypad Minus
  1515.                 0x14E    Keypad Period
  1516.                 0x14F    Keypad Slash
  1517.                 0x150    Keypad 0
  1518.                 0x151    Keypad 1
  1519.                 0x152    Keypad 2
  1520.                 0x153    Keypad 3
  1521.                 0x154    Keypad 4
  1522.                 0x155    Keypad 5
  1523.                 0x156    Keypad 6
  1524.                 0x157    Keypad 7
  1525.                 0x158    Keypad 8
  1526.                 0x159    Keypad 9
  1527.  
  1528.                 0x15A    Shift Keypad Left Parenthesis
  1529.                 0x15B    Shift Keypad Right Parenthesis
  1530.                 0x15C    Shift Keypad Asterisk
  1531.                 0x15D    Shift Keypad Plus
  1532.                 0x15E    Shift Keypad ENTER
  1533.                 0x15F    Shift Keypad Minus
  1534.                 0x160    Shift Keypad Period
  1535.                 0x161    Shift Keypad Slash
  1536.                 0x162    Shift Keypad 0
  1537.                 0x163    Shift Keypad 1
  1538.                 0x164    Shift Keypad 2
  1539.                 0x165    Shift Keypad 3
  1540.                 0x166    Shift Keypad 4
  1541.                 0x167    Shift Keypad 5
  1542.                 0x168    Shift Keypad 6
  1543.                 0x169    Shift Keypad 7
  1544.                 0x16A    Shift Keypad 8
  1545.                 0x16B    Shift Keypad 9
  1546.                 0x16C    CloseGadget
  1547.  
  1548.             0x0200    Control key flag
  1549.             0x0400    Meta (ESCAPE) flag
  1550.             0x0800    Control X flag
  1551.  
  1552.  
  1553. Command Name:    getrxmacro
  1554. Default Key:    UNBOUND
  1555. Description:    This command gets the contents of the current macro stored 
  1556.         in the keyboard macro buffer, converts it to a simple Arexx
  1557.         program, and returns it in the Arexx result string.  Because
  1558.         this program can be fairly long, it can result in the amount
  1559.         of memory used by AME for its Arexx result strings growing.
  1560.  
  1561. Command Name:     getword
  1562. Default Key:     UNBOUND     
  1563. Description:    This command gets the current word at the current cursor
  1564.         location and returns it in the Arexx result variable.  
  1565.         If there is no word under the cursor, the next word is returned.
  1566.  
  1567. Command Name:     getwindowsize
  1568. Default Key:     UNBOUND
  1569. Description:    This command returns the size of the area of the Intuition
  1570.         window available for use as display window area in the Arexx
  1571.         result variable.  The dimensions are returned as number of
  1572.         character rows, followed by number of character columns.
  1573.  
  1574. Command Name:     globalrx
  1575. Default Key:     UNBOUND         
  1576. Description:    AME will ask for the Arexx command, then it executes it, then
  1577.         sends it to all other AMEs running on that Amiga at that time,
  1578.         with instructions to execute the command as well.  The results
  1579.         of the command execution are returned in the Arexx result
  1580.         variable, in the form:
  1581.  
  1582.         .arexx port extention YES|NO
  1583.  
  1584.         so, for example, if there are three AMEs active (with
  1585.         Arexx port names AME.01  AME.03 and AME.04) you would get
  1586.         the following result, assuming the command succeeded on
  1587.         AME.01 and AME.04, and failed on AME.03
  1588.  
  1589.         .01 YES .03 NO .04 YES
  1590.  
  1591.         A null command can also be sent to just find out all
  1592.         the active AME Arexx port names.
  1593.         
  1594. Command Name:    hide
  1595. Default key:    UNBOUND
  1596. Description:    This command will rehide folds temporarily revealed
  1597.         by the show command.
  1598.  
  1599. Command Name:    hideall
  1600. Default key:    UNBOUND
  1601. Description:    This command will rehide all folds temporarily revealed
  1602.         by the show command.
  1603.  
  1604. Command Name:    hideblock
  1605. Default key:    UNBOUND
  1606. Description:    This command will rehide folds temporarily revealed
  1607.         by the show command in the current block.
  1608.  
  1609. Command Name:     hunt
  1610. Default Key:     UNBOUND
  1611. Description:    AME asks for the project name to hunt for and a filename;  
  1612.         if that version on AME is not associated with that project name
  1613.         it sends messages to all other active AMEs, inquiring if
  1614.         any of them are associated with that project name,
  1615.         If any of the AMEs contacted is associated with that project
  1616.         name it VISITs the filename, then moves its
  1617.         Intuition window to the front.
  1618.  
  1619. Command Name:    iconify
  1620. Default Key:    UNBOUND
  1621. Description:    This command closes the AME window, and creates an AppIcon
  1622.         on the Workbench window.  The AME icon can be moved
  1623.         like any other Workbench icon.  Double clicking
  1624.         on the icon will reopen the AME window.  Dropping
  1625.         files on the icon will reopen the AME window, loading
  1626.         those files.  Sending any AREXX command will also
  1627.         reopen the AME window.  (sending a BREAK signal will
  1628.         reopen the AME window momentarily;  AME will immediately
  1629.         exit).
  1630.  
  1631. Command Name:     insert
  1632. Default Key:     UNBOUND
  1633. Description:    This command takes characters as an argument;  all characters
  1634.         sent are treated as if they were typed from the keyboard.
  1635.         For almost all purposes, the text command is prefered.
  1636.  
  1637. Command Name:     item
  1638. Default Key:     UNBOUND
  1639. Description:    This command is used to enter a menu item into the AME menu.
  1640.         AME wiill ask for a slot number (-1 can be used for an
  1641.         append to current menu strip operation), then asks for
  1642.         the label to be used in the menu, the command to be executed
  1643.         when that menu is selected, and the optional shortcut key.
  1644.         Menus are automatically disabled when this command is used,
  1645.         to speed entry of multiple menu items, and must be reenabled
  1646.         with the onmenu command.
  1647.  
  1648. Command Name:     lockdisplay
  1649. Default Key:     UNBOUND         
  1650. Description:    This command locks the display window.  No changes appear to take
  1651.         place until the unlockdisplay command is received.  The modeline
  1652.         is not locked.  Input is still received, so any characters
  1653.         typed are actually placed in the buffer;  they are merely not
  1654.         displayed.
  1655.  
  1656. Command Name:     lockmodeline
  1657. Default Key:     UNBOUND
  1658. Description:    This command locks the mode and echo lines.  However, if AME 
  1659.         really wants to ask you something, it will.  The lockmodeline
  1660.         command can best be viewed as a request to AME to keep
  1661.         requests to a minimum.  It can be useful during script execution,
  1662.         to stop commands from displaying options in the mode line during
  1663.         execution.
  1664.  
  1665. Command Name:     menutitle
  1666. Default Key:     UNBOUND
  1667. Description:    AME will ask for the slot number (-1 for an append operation),
  1668.         and a label, then sets a menu title to that label.  Menus
  1669.         are automatically diisabled when this command is executed,
  1670.         and must be turned on with the onmenu command.
  1671.  
  1672. Command Name:     new
  1673. Default Key:     UNBOUND
  1674. Description:    AME will ask for the name of the new buffer, then
  1675.         create it.  If a name is given that already exists, AME
  1676.         will modify the name to be unique, by appending a number
  1677.         to it.
  1678.  
  1679. Command Name:     nop
  1680. Default Key:     UNBOUND
  1681. Description:    This command does nothing.  It is useful, for example, to
  1682.         bind to a key to make that key do nothing.
  1683.  
  1684. Command Name:     onmenu
  1685. Default Key:     UNBOUND
  1686. Description:    This command activates the AME menus.
  1687.  
  1688. Command Name:     paste
  1689. Default Key:     UNBOUND
  1690. Description:    This command will copy the characters from unit 0 of the 
  1691.         Amiga clipboard.device to the current cursor location.  
  1692.         This command is usually placed in the EDIT menu, with its 
  1693.         shortcut key set to V, following the style guide.
  1694.         You can paste into the mode line, by the way.
  1695.  
  1696. Command Name:     pastekill
  1697. Default Key:     UNBOUND
  1698. Description:    This command will copy the characters from unit 0 of the 
  1699.         Amiga clipboard.device to the kill buffer.
  1700.  
  1701. Command Name:     popup
  1702. Default Key:     UNBOUND
  1703. Description:    This command will cause the popup buffer to appear and
  1704.         be made the current buffer.  If called
  1705.         with an argument, the buffer will be cleared;  otherwise
  1706.         it will contain whatever information it contained when it was 
  1707.         last used.  This command makes it easy for external programs 
  1708.         to feed popup information to AME.
  1709.  
  1710. Command Name:     requestfile
  1711. Default Key:     UNBOUND
  1712. Description:    This command causes AME to request a file name from the user.
  1713.         If the REQ or FREQ variables are set, the asl library file
  1714.         requester will be used; otherwise the file name will be 
  1715.         requested in the mode line.  The file name selected is returned
  1716.         in the Arexx result variable.
  1717.  
  1718. Command Name:    requestkey
  1719. Default Key:    UNBOUND
  1720. Description:    Get a key from the keyboard; the value of the key is
  1721.         returned as a hexadecimal number.  See the getrxkey for
  1722.         key table.
  1723.  
  1724. Command Name:     requestline
  1725. Default Key:     UNBOUND         
  1726. Description:    This command causes AME to request a line of input from the
  1727.         user.  If the REQ variable is set, AME will bring up a
  1728.         string requester for the input;  otherwise the line
  1729.         is expected to be typed in the echo line.  The requestline
  1730.         command takes an argument for the prompt to use when
  1731.         requesting user input.  The line typed is returned in the
  1732.         Arexx result variable.
  1733.  
  1734. Command Name:     requestresponse
  1735. Default Key:     UNBOUND
  1736. Description:    This command causes AME to request yes or no response from the
  1737.         user.  If the REQ variable is set, AME will bring up an
  1738.         easy requester for the input, with two buttons marked
  1739.         OK anbd CANCEL;  otherwise the response is expected in the 
  1740.         echo line.  The requestresponse
  1741.         command takes an argument for the prompt to use when
  1742.         requesting user input.  The response (OK or CANCEL) is returned
  1743.         in the Arexx result variable.
  1744.  
  1745. Command Name:     setcurrentdir
  1746. Default Key:     UNBOUND
  1747. Description:    This command sets the current directory associated with
  1748.         AME.
  1749.  
  1750. Command Name:     settitle
  1751. Default Key:     UNBOUND
  1752. Description:    AME will ask for a new title.  This title is used as the
  1753.         window title for the AME Intuition window.
  1754.  
  1755. Command Name:    show
  1756. Default Key:    UNBOUND
  1757. Description:    This command will temporarily reveal all folded lines.
  1758.         on each side of the current cursor position.  AME will scan
  1759.         the file in each direction and reveal folded lines, stopping
  1760.         at the first unfolded line. The lines will stay revealed until 
  1761.         hidden.  Revealed lines are indicated by a leading | symbol.
  1762.  
  1763. Command Name:    showall
  1764. Default Key:    UNBOUND
  1765. Description:    This command will temporarily reveal all folded lines.
  1766.         The lines will stay revealed until hidden. 
  1767.         Revealed lines are indicated by a leading | symbol.
  1768.  
  1769. Command Name:    showblock
  1770. Default Key:    UNBOUND
  1771. Description:    This command will temporarily reveal all folded lines in the
  1772.         current block.  The lines will stay revealed until hidden.
  1773.         Revealed lines are indicated by a leading | symbol.
  1774.  
  1775. Command Name:     sleep
  1776. Default Key:     UNBOUND
  1777. Description:    AME will use the universal argument and wait for that many
  1778.         seconds.  If given a negative argument, it will wait for that
  1779.         many 50ths of a second.
  1780.  
  1781.  
  1782. Command Name:     subitem
  1783. Default Key:     UNBOUND
  1784. Description:    This command is used to enter a menu sub item into the AME menu.
  1785.         AME wiill ask for a slot number (-1 can be used for an
  1786.         append to current menu strip operation), then asks for
  1787.         the label to be used in the menu, the command to be executed
  1788.         when that menu is selected, and the optional shortcut key.
  1789.         The subitem is automatically attached to the nearest previous
  1790.         menu item, so a menu item can have the normal multiple
  1791.         collection sub items.    Menus are automatically disabled when this command 
  1792.         is used, to speed entry of multiple items, and must be reenabled
  1793.         with the onmenu command.
  1794.  
  1795. Command Name:     text
  1796. Default Key:     UNBOUND
  1797. Description:    AME will insert the character string passed as an argument
  1798.         to the text command at the current cursor location.
  1799.  
  1800. Command Name:     undoboundary
  1801. Default Key:     UNBOUND
  1802. Description:    This command inserts an undo boundary character into the
  1803.         undo buffer.  It is normally used to seperate undoable
  1804.         operations, and is automatically called when undo
  1805.         is active.
  1806.  
  1807. Command Name:     undomore
  1808. Default Key:     UNBOUND
  1809. Description:    This command will undo an additional operation, up to the
  1810.         next boundary.  It is not normally called directly.  It is
  1811.         automatically called when undo is active.
  1812.  
  1813. Command Name:     undostart
  1814. Default Key:     UNBOUND
  1815. Description:    Begin a new undo operation.  This command is not normally
  1816.         called directly.
  1817.  
  1818. Command Name:     unlockdisplay
  1819. Default Key:     UNBOUND
  1820. Description:    Unlock the display window so changes made appear.
  1821.  
  1822. Command Name:     unlockmodeline
  1823. Default Key:     UNBOUND
  1824. Description:    Unlock the mode and echo lines, so normal output appears.
  1825.  
  1826. Command Name:    unfold
  1827. Default Key:    UNBOUND
  1828. Description:    This command unfolds an entire fold, by scanning forwards
  1829.         and back from the current line, unfolding one level
  1830.         of folds, until an unfolded line is encountered.
  1831.  
  1832. Command Name:    unfoldall
  1833. Default Key:    UNBOUND
  1834. Description:    This command unfolds all folds.  If you just want to
  1835.         unfold one level of folds, set a block that covers
  1836.         the entire file, and use unfoldblock.
  1837.  
  1838. Command Name:    unfoldblock
  1839. Default Key:    UNBOUND
  1840. Description:    This command unfolds the current block by one fold 
  1841.         level.
  1842.  
  1843. Command Name:     windowtoback
  1844. Default Key:     UNBOUND
  1845. Description:    Send the AME Intuition window to the back.
  1846.  
  1847. Command Name:     windowtofront
  1848. Default Key:     UNBOUND
  1849. Description:    Bring the AME Intuition window to the front.
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855. AME VARIABLES
  1856.  
  1857. Variable Name:    ADDRESS
  1858. Description:    Default port to send Arexx messages.
  1859. Variable Type:    string
  1860. Initial value:    REXX
  1861.  
  1862. Variable Name:    BACKUP
  1863. Description:    create a backup file whenever a save operation
  1864.         is performed.
  1865. Variable type:    boolean
  1866. Initial value:    unset
  1867.  
  1868. Variable Name:    BEEP
  1869. Description:    Whether AME will beep on error, on searches not found, etc.
  1870. Variable Type:    boolean
  1871. Initial value:    set
  1872.  
  1873. Variable Name:    CASE
  1874. Description:    Case sensitive search
  1875. Variable type:    boolean
  1876. Initial value:  unset
  1877.  
  1878. Variable Name:    CHECK
  1879. Description:    Positive numeric value for number of keys hit
  1880.         between creation of checkpoint file.  If this value is
  1881.         0 no checkpoint files will be saved.
  1882. Variable type:    numeric
  1883. Initial value:    0
  1884.  
  1885. Variable Name:    CMODE
  1886. Description:    C mode (brace checking, C style indent).  This mode is 
  1887.         automatically turned on for a buffer when a file with a C ending
  1888.         is loaded (.c or .h)
  1889. Variable type:    boolean
  1890. Initial value:    unset
  1891.  
  1892. Variable Name:    COLOR
  1893. Description:    Color for text line. (from 0 to 7).
  1894. Variable type:    numeric
  1895. Initial value:    3
  1896.  
  1897. Variable Name:    CONWAIT
  1898. Description:    Wait factor for con-handler I/O.   This variable is used
  1899.         to increase the amount of time AME will wait for a character
  1900.         from the terminal before looking for other events.  This
  1901.         value must be increased for use on a terminal less
  1902.         than 300 baud (5000 suggested).  If escape sequences seem
  1903.         to be broken up the CONWAIT value should be increased.
  1904. Variable type:    numeric
  1905. Initial value:    2500
  1906.  
  1907. Variable Name:    EOL
  1908. Description:    Whether to track the ends of lines on up/down cursor movement, 
  1909.         or attempt to stay in the same column.
  1910. Variable type:    boolean
  1911. Initial value:    unset
  1912.  
  1913. Variable Name:    FOLDS
  1914. Description:    Global flag controlling whether folds are allowed
  1915. Variable type:    boolean
  1916. Initial value:    set
  1917.  
  1918. Variable Name:    FREQ
  1919. Description:    Use the ASL library  file requester
  1920. Variable type:    boolean
  1921. Initial value:    set (unless the WINDOW keyword is specified)
  1922.  
  1923. Variable Name:    ICONS
  1924. Description:    save default project icons with files
  1925. Variable type:    boolean
  1926. Initial value:    unset
  1927.  
  1928. Variable Name:    INDENT
  1929. Description:    positive numeric column to indent to when indent
  1930.         function is called
  1931. Variable type:    numeric
  1932. Initial value:    4
  1933.  
  1934. Variable Name:    LEFT
  1935. Description:    positive numeric value for the left margin
  1936. Variable type:    numeric
  1937. Initial value:    0
  1938.  
  1939. Variable Name:    MBYTE
  1940. Description:    Follow EUC rules for the extended 16 bit character set
  1941. Variable type:    boolean
  1942. Initial value:    unset
  1943.  
  1944. Variable Name:    MODE
  1945. Description:    all mode variables
  1946. Variable type:    boolean
  1947. Initial value:    unset
  1948.  
  1949. Variable Name:    MCOLOR
  1950. Description:    Background color for mode line. (from 0 to 7;  0 indicates 
  1951.         a special mode, in which AME uses normal background color, but 
  1952.         uses the - character for the mode line.)  If the mode line
  1953.         background color is set to the same color as the text color,
  1954.         the mode line background color is set to the highlight    
  1955.         color, and the modeline forground color is set to
  1956.         background color.
  1957.  
  1958. Variable type:    numeric
  1959. Initial value:    3
  1960.  
  1961. Variable Name:    OVER
  1962. Description:    overwrite mode
  1963. Variable type:    boolean
  1964. Initial value:    unset
  1965.  
  1966. Variable Name:    PROJECT
  1967. Description:    Name of project
  1968. Variable Type:    string
  1969. Initial value:    <NONE>
  1970.  
  1971. Variable Name:    READ
  1972. Description:    Make the buffer readonly.  The text in the buffer cannot be
  1973.         changed when in readonly mode.  This mode is automatically
  1974.         set when a write protected file is read into a new buffer.
  1975. Variable Type:    boolean
  1976. Initial value:    unset
  1977.  
  1978. Variable Name:    REGEX
  1979. Description:    Regular expression search
  1980. Variable type:    boolean
  1981. Initial value:  set
  1982.  
  1983. Variable Name:    REQ
  1984. Description:    Turn on all requesters (including file requester)
  1985. Variable type:    boolean
  1986. Initial value:    unset
  1987.  
  1988. Variable Name:    RIGHT
  1989. Description:    positive numeric value for the right margin
  1990. Variable type:    numeric
  1991. Initial value:    70
  1992.  
  1993. Variable Name:    RXCON
  1994. Description:    Default console for Arexx standard input/output.
  1995. Variable Type:    string
  1996. Initial value:    NIL:
  1997.  
  1998. Variable Name:    SCORE
  1999. Description:    Special update mode, optimized for large
  2000.         windows (like when using AME on the A2024 Workbench)
  2001. Variable type:    boolean
  2002. Initial value:  unset
  2003.  
  2004. Variable Name:    TAB
  2005. Description:    positive numeric value for the number of spaces
  2006.         inserted when the tab key is hit.  If TAB is 0,
  2007.         a real tab is inserted.  (A real tab is always 8).
  2008. Variable type:    numeric
  2009. Initial value:    0
  2010.  
  2011. Variable Name:    TEMP
  2012. Description:    Whether this buffer has to be saved before exiting, and whether
  2013.         AME will ask before replacing this buffer.
  2014. Variable Type:    boolean
  2015. Initial value:    unset
  2016.  
  2017. Variable Name:    UNDO
  2018. Description:    Record changes for undo operations.
  2019. Variable type:    boolean
  2020. Initial value:  unset
  2021.  
  2022. Variable Name:    USTEPS
  2023. Description:    Number of records allocated for undo operations.
  2024. Variable type:    numeric
  2025. Initial value:  1000
  2026.  
  2027. Variable Name:    WRAP
  2028. Description:    wrap on right column mode
  2029. Variable type:    boolean
  2030. Initial value:    unset
  2031.  
  2032. Variable Name:    Any Local AmigaDOS variable
  2033. Description:    A local AmigaDos variable
  2034. Variable type:  string
  2035. Initial value:
  2036.  
  2037.